home *** CD-ROM | disk | FTP | other *** search
/ NetNews Offline 2 / NetNews Offline Volume 2.iso / news / comp / lang / c-part2 / 13182 < prev    next >
Encoding:
Internet Message Format  |  1996-08-05  |  1.8 KB
  1. Path: rcp6.elan.af.mil!rscernix!danpop
  2. From: danpop@mail.cern.ch (Dan Pop)
  3. Newsgroups: comp.lang.c
  4. Subject: Re: FAQ list overspecificity (was: Very Simple <maths.h> problem...)
  5. Date: 4 Apr 96 19:50:50 GMT
  6. Organization: CERN European Lab for Particle Physics
  7. Message-ID: <danpop.828647450@rscernix>
  8. References: <4jf0c9$rs8@nic.umass.edu> <315B11FD.6460@oc.com> <DpAtJz.5z5@eskimo.com>
  9. NNTP-Posting-Host: ues5.cern.ch
  10. X-Newsreader: NN version 6.5.0 #7 (NOV)
  11.  
  12. In <DpAtJz.5z5@eskimo.com> scs@eskimo.com (Steve Summit) writes:
  13.  
  14. >The upside of the question as it's currently worded is that it
  15. >appeals to the FAQ maintainer's sense of how the game ought to be
  16. >played.  The downsides are that someone who knows he's not
  17. >"trying to do some simple trig," or who is searching mechanically
  18. >for the name of the one <math.h> routine he *is* having problems
  19. >with, may overlook question 14.3.
  20.  
  21. People who grep the FAQ instead of reading it get exactly what they
  22. deserve.
  23.  
  24. In this particular case, all that has to be read and not grepped
  25. is the table of contents for chapter 14.  If the reader cannot realize
  26. that the answer to the question:
  27.  
  28.     14.3:   I keep getting "undefined: sin" compilation errors.
  29.  
  30. may contain the solution to his "undefined: sqrt" problem, then maybe
  31. he would be better off choosing another career.
  32.  
  33. >I *do* assume, and hope, that someone reading 14.3 can
  34. >extrapolate to other <math.h> functions.  Perhaps I doth assume
  35. >too much.  Comments?
  36.  
  37. It is the right level of assumption, IMHO.  To paraphrase the Murphy Law
  38. book: If you write a FAQ that even an idiot could understand, only idiots
  39. will want to read it :-)
  40.  
  41. Keep the FAQ targeted at people with normal levels of intelligence.
  42.  
  43. Dan (who pushed Steve to provide a table of contents for the FAQ :-)
  44. --
  45. Dan Pop
  46. CERN, CN Division
  47. Email: danpop@mail.cern.ch 
  48. Mail:  CERN - PPE, Bat. 31 R-004, CH-1211 Geneve 23, Switzerland
  49.